home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat4 / mtune.z / mtune
Encoding:
Text File  |  2002-10-03  |  7.3 KB  |  133 lines
  1.  
  2.  
  3.  
  4. mmmmttttuuuunnnneeee((((4444))))                                                              mmmmttttuuuunnnneeee((((4444))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      mtune - default system tunable parameters
  10.  
  11. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  12.      The directory _////_vvvv_aaaa_rrrr_////_ssss_yyyy_ssss_gggg_eeee_nnnn_////_mmmm_tttt_uuuu_nnnn_eeee contains information about all the system
  13.      tunable parameters, including default values.  The files in this
  14.      directory should never be changed.  Instead, use the _ssss_yyyy_ssss_tttt_uuuu_nnnn_eeee(1M) utility
  15.      to change parameters in the _////_vvvv_aaaa_rrrr_////_ssss_yyyy_ssss_gggg_eeee_nnnn_////_ssss_tttt_uuuu_nnnn_eeee file.
  16.  
  17.      Each loadable module can have its own _mmmm_tttt_uuuu_nnnn_eeee file, which is placed in the
  18.      _mmmm_tttt_uuuu_nnnn_eeee directory and has the same name as the module.  Parameters in an
  19.      _mmmm_tttt_uuuu_nnnn_eeee file may be grouped together in groups, according to the nature of
  20.      the parameters.  For example, all parameters dealing with the number of
  21.      processes that can run on the system at any given time are grouped
  22.      together in the _nnnn_uuuu_mmmm_pppp_rrrr_oooo_cccc group in the _kkkk_eeee_rrrr_nnnn_eeee_llll module.  The syntax of an
  23.      _mmmm_tttt_uuuu_nnnn_eeee module file is given below:
  24.  
  25.           [_g_r_o_u_p__n_a_m_e: [_f_l_a_g]]
  26.           _p_a_r_a_m_e_t_e_r__c_l_a_u_s_e_s
  27.  
  28.      Names that end with a colon character, _::::, are group names.  Parameters
  29.      can be grouped together in groups so that one sanity checking function
  30.      can be used to verify the values and the dependencies between these
  31.      variables.  The group name is optional if there is only one group in the
  32.      module.  For this case, the configuration tools use the module name as
  33.      the group name.
  34.  
  35.      The group name is followed by a flag.  The flag can be either _rrrr_uuuu_nnnn or
  36.      _ssss_tttt_aaaa_tttt_iiii_cccc.  If the flag is _rrrr_uuuu_nnnn, this group of tunable variables can be
  37.      changed with the command _ssss_yyyy_ssss_tttt_uuuu_nnnn_eeee on a running system.  Otherwise, the
  38.      variables are set at initialization time and can be changed only by
  39.      creating a new kernel and booting that kernel.  Modules with no group
  40.      specifier or a group specifier without a flag default to _ssss_tttt_aaaa_tttt_iiii_cccc.
  41.  
  42.      Each tunable parameter is specified by a single line, a parameter clause,
  43.      in the file.  Blank lines and lines beginning with _#### or _**** are considered
  44.      comments and are ignored.  The syntax for each line is:
  45.  
  46.           _n_a_m_e[,_t_a_g] _d_e_f_a_u_l_t__v_a_l_u_e [[_m_i_n__v_a_l_u_e [_m_a_x__v_a_l_u_e [ll|LL]]
  47.  
  48.      _n_a_m_e             The name of the tunable parameter.  It is used to pass
  49.                       the value to the system when a kernel is built or
  50.                       changed by _ssss_yyyy_ssss_tttt_uuuu_nnnn_eeee command.  Since this name is made
  51.                       into a global variable name, using a long descriptive
  52.                       name is useful to avoid any name collisions.
  53.  
  54.      _t_a_g              This optional field is separated from _n_a_m_e by a comma.
  55.                       It is used to qualify whether the tunable parameter
  56.                       should be used in the configuration being built.  This
  57.                       allows a single _tttt_uuuu_nnnn_eeee file to be used in multiple
  58.                       different configurations.  Parameters without any _t_a_g
  59.                       are always used, those with a _t_a_g are only used if the
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. mmmmttttuuuunnnneeee((((4444))))                                                              mmmmttttuuuunnnneeee((((4444))))
  71.  
  72.  
  73.  
  74.                       tag matches one of the _t_a_gs specified in the _ssss_yyyy_ssss_tttt_eeee_mmmm file
  75.                       (see _ssss_yyyy_ssss_tttt_eeee_mmmm(4)).  Only one _t_a_g is permitted on a given
  76.                       line.
  77.  
  78.      _d_e_f_a_u_l_t__v_a_l_u_e    The default value of the tunable parameter.  If the
  79.                       value is not specified in the _ssss_tttt_uuuu_nnnn_eeee file, this value is
  80.                       used when the system is built.  This value is mandatory.
  81.  
  82.      _m_i_n__v_a_l_u_e        The minimum allowable value for the tunable parameter.
  83.                       If the parameter is set in the _ssss_tttt_uuuu_nnnn_eeee file, the _llll_bbbb_oooo_oooo_tttt
  84.                       command checks that the new value is equal to or greater
  85.                       than this value.  The command _ssss_yyyy_ssss_tttt_uuuu_nnnn_eeee also verifies the
  86.                       new value against this value before changing the system.
  87.                       This field is optional; a value of 0 is equivalent to
  88.                       not specifying a value.
  89.  
  90.      _m_a_x__v_a_l_u_e        The maximum allowable value for the tunable parameter.
  91.                       If the parameter is set in the _ssss_tttt_uuuu_nnnn_eeee file, the _llll_bbbb_oooo_oooo_tttt
  92.                       command checks that the new value is equal to or less
  93.                       than this value.  The command _ssss_yyyy_ssss_tttt_uuuu_nnnn_eeee also verifies the
  94.                       new value against this value before changing the system.
  95.                       This field is optional; a value of 0 is equivalent to
  96.                       not specifying a value.
  97.  
  98.      _llll_llll|_LLLL_LLLL            By default, each tunable parameter is represented by an
  99.                       global variable in the kernel of type int (32 bits).
  100.                       Some tunable parameters may need to be specified as 64
  101.                       bit quantities.  Adding an _llll_llll or _LLLL_LLLL to the end of the
  102.                       parameter specification causes _llll_bbbb_oooo_oooo_tttt to represent the
  103.                       parameter as a _llll_oooo_nnnn_gggg _llll_oooo_nnnn_gggg.
  104.  
  105. FFFFIIIILLLLEEEESSSS
  106.      /var/sysgen/mtune/*    default system tunable parameters
  107.      /var/sysgen/stune      local settings for system tunable parameters
  108.      /var/sysgen/system/*   master system configuration files
  109.  
  110. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  111.      lboot(1M), systune(1M), stune(4), system(4).
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.